home *** CD-ROM | disk | FTP | other *** search
/ Utilities Professional 1-1500 / Utilities Professional 1-1500 (1994)(WPD)[!].iso / 12511500 / var1292.dms / var1292.adf / chasym / chasym.doc < prev    next >
Text File  |  1993-03-16  |  12KB  |  297 lines
  1.  
  2.  
  3.      ChaSym copyright (c) 1993 A.Kreibich
  4.  
  5.                           
  6.      Programmed by Andrew Kreibich with AMOSv1.35 (C) 1990 Mandarin/Jawx
  7.      
  8.      Compiled with the AMOS compiler v1.35.
  9.  
  10.  
  11.      Note: to quit at any time (without using the menu) press Ctrl-C.
  12.            to toggle workbench use left Amiga-A (Amiga N and M will not work)  
  13.  
  14.  
  15.  
  16.      OVERVIEW 
  17.      ########
  18.     
  19.      ChaSym (Chaos Symmetry)  is a programme which plots pictures of 
  20.      chaotic systems which display symmetry. This is done by repeated
  21.      iterations of the following equation.
  22.  
  23.      Z(n+1) = U * Z(n) * (1-(Z(n)^2) + G * (ZC(n))^(M-1)
  24.  
  25.      Where Z(n) is a complex number Z(n)=x+iy and ZC(n) is the complex conjugate
  26.      of Z(n).  ZC(n)= x-iy.
  27.   
  28.      You don't need to understand any of that to generate the pictures!
  29.  
  30.      The points produced are plotted on the screen and over a period of time a
  31.      picture  will develop. The colour of the points is determined by the
  32.      number of times the point has been visited. I.E. first time it is plotted 
  33.      with colour 1 (purple using the default palette). The colour increases in 
  34.      a non linear fashion up to colour 15 which represents at least 255 visits.
  35.  
  36.      This table shows the colour plotted for the number of visits.
  37.  
  38.              visits    colour
  39.                1          1
  40.               2-3         2
  41.               4-5         3
  42.               6-9         4
  43.              10-14        5
  44.              15-19        6
  45.              20-39        7
  46.              40-59        8
  47.              60-79        9
  48.              80-119      10
  49.             120-159      11
  50.             160-199      12
  51.             200-239      13
  52.             240-254      14
  53.           over 254       15           
  54.  
  55.  
  56.      The resulting picture is therefore a map of the probability of 
  57.      landing on the point. You can change the parameters in the equation
  58.      using the Change Data menu item.
  59.  
  60.      Note: depending on the choice of parameters one of three things will
  61.      happen.
  62.       1.  You will produce a nice picture displaying symmetry of the 
  63.           order chosen by the parameter M which will continue to generate
  64.           forever (if you let it go that long).
  65.  
  66.       2.  The points will quickly converge onto one spot (or small group of
  67.           spots) and stay there. As these are not very interesting you 
  68.           should change the parameters and restart.
  69.  
  70.       3.  The points will rapidly disappear off the screen never to return
  71.           (usually only takes half a dozen iterations). These are even 
  72.           less interesting than the ones in 2 so change the parameters.
  73.  
  74.       When you start the programme the default settings will automatically
  75.       start generating a picture with 25 fold symmetry (count it!). Use the
  76.       menu to change the parameters, but be careful with parameters U and G.
  77.       If both of these are big then the point will rapidly approach infinity.
  78.  
  79.   
  80.      You can load and save pictures and the parameters which you used to
  81.      create them by using the menus. There are a few which I have generated
  82.      in the drawer labelled 'examples'.
  83.  
  84.      If you don't understand the maths then just experiment with different 
  85.      parameters and enjoy the result.
  86.  
  87.  
  88.     THE FILE REQUESTER
  89.   
  90.     All loads and saves use the standard amos file requester. Most things are
  91.     self explanatory, just double click on the name of the file you want with
  92.     the left mouse button, or click on the area at the bottom and type in the
  93.     name of your file. The PARENT gadget is the small circle above the slider
  94.     bar at the left. A list of DEVICES/DRIVES can be obtained by clicking in
  95.     the central area with the right mouse button. (the area where the names 
  96.     of the files are displayed) The list of files can be redisplayed by 
  97.     clicking the right mouse button in this area a second time.
  98.  
  99.  
  100.  
  101.     Explanation of menu items
  102.  
  103.     Project menu
  104.  
  105.          Palette:     Brings up a palette requester so you can change colours
  106.                       See the file "Palette.doc" for details.
  107.  
  108.          Save IFF:    Lets you save your pictures.
  109.                       (Disabled in Demonstration version)
  110.  
  111.          Load IFF:    Lets you load your pictures back in to view or to
  112.                       generate something over the top. There is no point
  113.                       in continuing to generate as the table which holds
  114.                       the number of visits is not saved in this version, but
  115.                       you may wish to generate another picture on top of the
  116.                       old one using new data for example.
  117.  
  118.                       The pictures are standard IFF files so you 
  119.                       can also view/use them with other programmes.
  120.  
  121.             About:    Information about the programme.
  122.  
  123.              Quit:    Another fairly obvious one.
  124.  
  125.  
  126.       Parameters menu
  127.  
  128.       Change Data:   Brings up a screen so that you can change the value
  129.                      of each of the constants in the equation.
  130.  
  131.           Zoom In:   Press left mouse button on top left corner of the area 
  132.                      you wish to zoom in on. Drag the rubber band to the
  133.                      opposite  corner while you hold the left mouse button.
  134.                      The area you have selected will be enlarged to fill the 
  135.                      screen and the picture will be regenerated from the start.
  136.  
  137.          Zoom Out:   Works the same way as Zoom In except that the area on the
  138.                      screen will be shrunk into the area you have selected and
  139.                      the picture will regenerate."
  140.  
  141.   Nudge is ON/OFF:  Sometimes the picture gets 'stuck' while it is generating
  142.                     because the X and/or Y coordinates have reached zero. This
  143.                     results in a thick line in one part of the picture and is
  144.                     probably caused by an accumulation of rounding off errors.
  145.                     In order to get around this the NUDGE ON feature checks to
  146.                     see if either X or Y is zero and if it is it gives it a 
  147.                     'Nudge' by adding a small number so that generation can
  148.                     continue. If you don't like this then turn it off.
  149.  
  150.        Save Data:   Saves the settings from the parameter screen. 
  151.                     This version does not save zoom or palette settings
  152.                     and does not save the table which stores the count for
  153.                     each point. This may be added in the next version.
  154.                     This is disabled in the demonstration version.
  155.  
  156.        Load Data:  Loads a previously saved setting to the parameter screen. 
  157.                    You will find a selection of these in the Example drawer.
  158.  
  159.   Pause/Continue:  Lets you pause the generation process. This is used if you
  160.                    load a picture in and you don't want it covered in new 
  161.                    points. You can continue by selecting this menu item again.
  162.  
  163.  
  164.    Explanation of Parameter screen
  165.  
  166.       Each of the parameters in the equation (U, G and M) can be 
  167.       changed by dragging the appropriate slider bar.
  168.       Parameter M determines the symmetry of the resulting figure.
  169.       Parameters U and G have an effect on size and shape. (experiment!)
  170.       You can also change the position of the first point by
  171.       changing the X and Y parameters. This probably has little effect on the
  172.       final figure but can be useful to see what happens in various sections 
  173.       soon after the start.
  174.  
  175.     Continue and Restart buttons
  176.  
  177.     If you want to clear the screen and generate from the start select Restart.
  178.     If you want to continue generating without clearing the screen select
  179.     Continue. This can be used to draw two or more pictures on the same screen 
  180.     or when you load a previously generated picture and you want to continue 
  181.     generating. (When I enable the saving of the colour table).
  182.  
  183.  
  184.     FINALLY....
  185.  
  186.     Some combinations of parameters will send the points to infinity
  187.     in a very short time. As your screen isn't quite that big you will only 
  188.     see the first few dots. If this happens go back to the parameter screen 
  189.     and change a few things, in particular reduce the values of U and/or G.
  190.  
  191.  
  192.  
  193.      #####################
  194.       Memory requirements
  195.      #####################
  196.  
  197.      This programme needs 1 meg.
  198.  
  199.      You may run it from Workbench in the usual manner or from 
  200.      CLI.
  201.      Just cd to the directory containing chasym and type
  202.  
  203.      Run > Nil: chasym  
  204.      endcli
  205.      
  206.      (Make sure you have Run and endcli in your C directory)     
  207.      
  208.      If memory is short you could put it on its own boot disk and replace
  209.      your startup sequence with the above lines.
  210.     
  211.  
  212.      ################
  213.        DISTRIBUTION
  214.      ################
  215.  
  216.      THIS PROGRAMME IS SHAREWARE!
  217.  
  218.      This means that my ego and my wallet would appreciate a little feedback
  219.      for all my efforts!
  220.      You may (and are encouraged to) distribute the Shareware version of this
  221.      programe to anyone providing you observe the following conditions.
  222.     
  223.  
  224.      (a) You don't make any money from it (apart from a nominal copying fee)
  225.          without my prior written permission.
  226.  
  227.      (b) You may not include it or any routines from it in any commercial
  228.          release (including SHAREWARE or one of its variations) without
  229.          my prior written permission. 
  230.  
  231.      (c) You distribute this entire doc. file and all other files with the
  232.          programme.
  233.  
  234.      (d) Magazines may include it on a cover disk provided they include ALL
  235.          files including .doc files.
  236.  
  237.      (e) If you use it you write back and let me know what you think of it
  238.          along with a shareware donation. (minimum $15 Australian)
  239.  
  240.               To  Andrew Kreibich
  241.                   Box 333
  242.                   Wantirna South
  243.                   Victoria
  244.                   Australia.  3152
  245.  
  246.      Please try to send money in Australian dollars, or a cheque drawn on
  247.      an Australian bank (your bank should be able to arrange this),
  248.      our banks charge a  fortune to convert:- another benefit of 
  249.      deregulation?.     
  250.  
  251.      If you have trouble obtaining Australian Dollars, I can cope with
  252.      English, USA, Canadian or German money, but it costs me money to change 
  253.      it so please add $5.
  254.  
  255.      PLEASE DO NOT SEND EUROCHEQUES!! It costs me over $40 to convert these!
  256.      Any Eurocheck I receive will be sent back WITHOUT the software. 
  257.      Unfortunately I cannot afford to send it and hope that you return
  258.      the money. I did this once and never heard from the guy again. 
  259.      (You may be feeling quite smug, Jurgen, but you have spoiled it for
  260.      everyone else!)
  261.      As they say; Once bitten, twice shy!    
  262.  
  263.  
  264.      Naturally if you think I have done a really fantastic job on this 
  265.      and you cannot help but show your appreciation by sending more money 
  266.      (Australian Dollars!) etc. then I will happily accept it! 
  267.  
  268.      
  269.      WHAT DO YOU GET FOR REGISTERING?
  270.      My thanks, the knowledge that you have encouraged me to keep programming
  271.      and releasing stuff, the source and of course a fully working version.
  272.      (all saves are disabled in the shareware demonstration version.)
  273.      Source code will only be sent to those who specifically ask for it.
  274.  
  275.      I am thinking of adding a few new features such as:
  276.  
  277.      Load/Save palette settings and zoom information with the parameter files.
  278.  
  279.      Load/Save the table which registers the amount of visits to each point.
  280.      This will allow you to load in a partially generated picture as well
  281.      as the table and contiue generating at a later date.
  282.  
  283.      Giving the option of altering the way colours are plotted so that you
  284.      can control how quickly points reach colour 15. This  may allow you to 
  285.      bring out more detail in some areas of the picture. 
  286.  
  287.     By the time you read this I should have finished these improvements, so
  288.     you can have them in your registered version if you want them.
  289.  
  290.     Any other ideas or suggestions will be incorporated if possible.
  291.  
  292.  
  293.    Hope you enjoy the programme,
  294.  
  295.    Andrew.
  296.     
  297.